home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / maklst10.zip / MAKE-LST.DOC < prev    next >
Text File  |  1992-10-20  |  14KB  |  275 lines
  1.  
  2.     MAKE-LST.DOC                                          Page:1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                               MAKE-LST Version 1.00
  10.               The Most Powerful Master File List Creation Utility
  11.            Copyright (C) 1992 Lightning Software, All Rights Reserved
  12.                       Written And Coded By Robert L. Folmer
  13.  
  14.                ** Support Board: Software Express (404) 941-2822 **
  15.  
  16.          Warranty
  17.          ========
  18.          MAKE-LST 1.00 is distributed without warranty. In no event
  19.          will Lightning Software be liable to you for any damages from
  20.          running this program. Including any loss of profits, lost
  21.          savings, or other incidental or consequential damages arising
  22.          out of your use of or inability to use the program, even if
  23.          Lightning Software or a authorized representative has been
  24.          advised of the possibility of such damages.
  25.          Lightning Software will not be liable for any such claim by
  26.          any other party. All risk associated with using this program
  27.          are the complete responsibility of the user.
  28.  
  29.          Introduction
  30.          ============
  31.          MAKE-LST is a powerful utility for use with most any Bulletin Board
  32.          System that uses standard ASCII directory listing files, among these
  33.          include RBBS-PC (using standard .DIR ASCII files), TriBBS, PCBoard
  34.          plus thousands of others. MAKE-LST (short for Make-List) allows you
  35.          to generate a complete master file listing for your users to download
  36.          and view in their own individual time, it's not your ordinary file
  37.          list utility! Here are just a few of it's many useful features:
  38.  
  39.          - FAST processing! MAKE-LST is capable of processing up to 10,000
  40.            files within one minute, of course this does vary with different
  41.            CPU processors.
  42.  
  43.          - High speed CPU timer clock routines, assure that you won't be
  44.            waiting for MAKE-LST.
  45.  
  46.          - Supports up to a total of 50 file categories (not files) which
  47.            allows you to categorize your files as they are on your system.
  48.  
  49.          - Supports an unlimited number of files, MAKE-LST is capable of
  50.            processing an unlimited number of files, which means it can
  51.            process how many ever files you have with no worries on future
  52.            expansion.
  53.  
  54.          - Includes handy sort utility, that sorts file listings by name,
  55.            keeps your file listings up to date.
  56.  
  57.          - Direct support for RBBS-PC (using standard .DIR ASCII files), 
  58.            TriBBS, PCBoard and many more, supports any system that uses
  59.            standard ASCII text file directory listings for each file
  60.  
  61.  
  62.     MAKE-LST.DOC                                          Page:2
  63.  
  64.  
  65.  
  66.            category.
  67.  
  68.          - Written in QuickBasic 4.5 for speed and memory optimization.
  69.  
  70.          - Easy to use and requires no maintenance.
  71.  
  72.          As you can see from above MAKE-LST has numerous features, it's also
  73.          very easy to install and get running! Please remember that MAKE-LST
  74.          is distributed under the shareware concept, and requires registration
  75.          for continued use, MAKE-LST is the result of hundreds of hours and
  76.          deserves your support. The evaluation version of MAKE-LST is a fully
  77.          functioning software package, rather than disable any of the programs
  78.          features MAKE-LST has been distributed completely functional and
  79.          therefore generates all file lists, however there are a few
  80.          restrictions, the unregistered version of MAKE-LST cannot be run
  81.          as a nightly event, and contains unregistered notices throughout
  82.          the software and in the lists it generates. Registering MAKE-LST will
  83.          get rid of all of these restrictions and will be registered in your
  84.          (or your BBS's) name which will then be displayed to your callers.
  85.          There are also many other registration benefits, please see the
  86.          section titled "Registration" in this users guide for complete
  87.          details. Thank you for using MAKE-LST!
  88.  
  89.          Installation
  90.          ============
  91.          Installing MAKE-LST is very simple and straight forward, there are
  92.          only a few installation steps necessary before use. To begin you
  93.          must first select where you would like to install MAKE-LST, the
  94.          program can be run from a floppy diskette based system, a hard disk
  95.          drive or a RAM disk, in all respects it is recommended that MAKE-LST
  96.          be installed on a hard disk drive or a RAM disk, use of a floppy disk
  97.          based system is not recommended. MAKE-LST can also be placed in a
  98.          path statement in your AUTOEXEC.BAT file, doing so allows you to run
  99.          the program without first having to change to the directory it's files
  100.          reside in. This guide assumes you are installing MAKE-LST on a hard
  101.          disk drive.
  102.  
  103.          To install, create a directory to hold all of the MAKE-LST files,
  104.          then uncompress the MAKE-LST archive into the newly created directory.
  105.  
  106.          There are a few configuration files which must be made before MAKE-LST
  107.          can be used, first you must create a main configuration file, the
  108.          format of this file is shown below, you may name the file anything
  109.          you wish (MAKE-LST.CFG is recommended).
  110.  
  111.          MAKE-LST.CFG Format:
  112.  
  113.          Software Express                    - The name of your BBS as it will
  114.                                                appear to your callers. 
  115.          Hardware & System Utilities         - List all of your file categories
  116.          Entertainment                         here, 1 per line, 50 lines
  117.          Communications & Protocols            maximum. List only the title
  118.          DOS & General File Utilities          of each area here.
  119.          Magazine Files & Misc                  
  120.  
  121.  
  122.     MAKE-LST.DOC                                          Page:3
  123.  
  124.  
  125.  
  126.  
  127.          NOTE! THERE SHOULD BE NO BLANK LINES IN MAKE-LST.CFG!
  128.  
  129.          The next step is to create a directory locations configuration file,
  130.          this files purpose is to tell MAKE-LST where each directory listing
  131.          is located and their filename, these directories should be in the 
  132.          order you listed the category names in MAKE-LST.CFG. Here again this 
  133.          file may be named anything you wish (DIR.CFG is recommended).
  134.  
  135.          DIR.CFG Format:
  136.  
  137.          C:\BBS\FILES\SYSTEM\FILES.LST       - List all of your file and
  138.          C:\BBS\FILES\ENTAIN\FILES.LST         directory list locations here,
  139.          C:\BBS\FILES\COMM_PRO\FILES.LST       include the full path and
  140.          C:\BBS\FILES\UTILITY\FILES.LST        filename of each list. 1 per
  141.          C:\BBS\FILES\MAG_MISC\FILES.LST       line, 50 lines maximum. These
  142.                                                should be entered in the order
  143.                                                of the categories you entered
  144.                                                in the MAKE-LST.CFG file above.
  145.  
  146.          NOTE! THERE SHOULD BE NO BLANK LINES IN DIR.CFG!
  147.  
  148.          After completing the above steps, MAKE-LST is completely setup and
  149.          ready for operation! The next section details how to start and use
  150.          the MAKE-LST master file list creation utility.
  151.  
  152.          Running MAKE-LST
  153.          ================
  154.          MAKE-LST uses several command line parameters for the greatest
  155.          flexibility, the following shows the MAKE-LST command line syntax:
  156.  
  157.          Command Line Syntax:
  158.  
  159.          MAKE-LST [full path & name of config file] [full path & name of
  160.          directory locations file] [optional master file list name defaults to
  161.          'MASTER.LST' if no name given]
  162.  
  163.          As an example, if you have installed MAKE-LST in a directory of
  164.          C:\MAKE-LST, you could run the program with the following command
  165.          line, this example will name the master file listing BBS.LST, if you
  166.          do not specify a name of the list to generate, MAKE-LST uses
  167.          MASTER.LST.
  168.  
  169.          MAKE-LST C:\MAKE-LST\MAKE-LST.CFG C:\MAKE-LST\DIR.CFG BBS.LST
  170.  
  171.          Note: If running MAKE-LST in the same directory as it's configuration
  172.                files reside, it is un-necessary to enter a path, the only time
  173.                this procedure is necessary is when running MAKE-LST from
  174.                a path with the configuration files located in another
  175.                directory.
  176.  
  177.          Remember that MAKE-LST always creates a file listing in the current
  178.          directory, so if MAKE-LST was installed in your path and you run the
  179.          program from the C:\BBS directory, the output file listing would
  180.  
  181.  
  182.     MAKE-LST.DOC                                          Page:4
  183.  
  184.  
  185.  
  186.          reside in the C:\BBS directory. MAKE-LST always deletes the old
  187.          listing if it exist before creating a new master list. DO NOT include 
  188.          any pathname when specifying a master file list! MAKE-LST is designed
  189.          to generate it's file list in the current directory the program is 
  190.          run from, list ONLY the filename of the file list you want generated.
  191.  
  192.          Using The T-SORT Utility
  193.          ========================
  194.          T-SORT is a "quick and simple" utility that has been included with
  195.          MAKE-LST, it's purpose is to sort your file listings by filename,
  196.          T-SORT is intended for use only with file listings which have only
  197.          the filename in column 1, it does not sort by date, T-SORT should
  198.          not be used on systems having multiline file descriptions, since
  199.          all data would appear throughout the listing in the wrong order.
  200.          Using T-SORT will allow you to keep your file listings up to date 
  201.          in alphabetic order, doing so allows your callers to find files 
  202.          much quicker and easier. T-SORT is a command line driven utility 
  203.          which has 3 arguments passed to it, the format is as follows:
  204.  
  205.          T-SORT [input file name] [output file name] [/r (optional)]
  206.  
  207.          The [input file name] should be the full path and filename of a ASCII
  208.          file list to sort, and [output file name] should be the full path and
  209.          filename of the output sorted file list. And finally the /r is an
  210.          optional switch that lets you specify whether sorting should be
  211.          performed in reverse order, T-SORT normally sorts files from top to
  212.          bottom (A-Z), using this switch forces T-SORT to sort from bottom to
  213.          top (Z-A), this is an optional switch, if not specified, T-SORT will
  214.          perform sorting in top to bottom fashion (this is the recommended
  215.          order).
  216.  
  217.          It is important to note that T-SORT requires the DOS utility SORT
  218.          to sort files properly, the T-SORT utility requires information
  219.          output from SORT in order to write sorted data correctly to the 
  220.          target file. SORT should be installed either in the same directory
  221.          T-SORT is run from, or somewhere in your path.
  222.  
  223.          T-SORT should not be used on the master file listing MAKE-LST
  224.          generates, if you would like the files sorted in the master listing
  225.          run T-SORT to sort your original directory listings first, then run
  226.          MAKE-LST.
  227.  
  228.          T-SORT can handle files as large as 64K.
  229.  
  230.          T-SORT is not limited to processing file listings, you may use T-SORT
  231.          on any ASCII text file that you want sorted in alphabetic order.
  232.  
  233.          T-SORT is a free utility included with MAKE-LST and does not require
  234.          registration to use. However it is part of the MAKE-LST software and
  235.          should be distributed only with MAKE-LST and never distributed by
  236.          itself.
  237.  
  238.          Registration
  239.          ============
  240.  
  241.  
  242.     MAKE-LST.DOC                                          Page:5
  243.  
  244.  
  245.  
  246.          MAKE-LST 1.00 is being distributed under the shareware concept,
  247.          you are free to use this product for a period of 30 days after
  248.          which you must either register the program or discontinue it's use.
  249.          Registration is only $10.00, registering MAKE-LST allows you to run
  250.          the utility during a nightly event for completely automated
  251.          processing, and removes the "Hit [ENTER]" prompt appearing when
  252.          processing has completed, registration also removes all unregistered
  253.          notices seen throughout the software and in the master file listings
  254.          MAKE-LST generates. When you register MAKE-LST you will receive a
  255.          fully functional registered version of the software registered in
  256.          your (or your BBS's) name, your registration number will then
  257.          appear when running MAKE-LST and displayed within the master file
  258.          list MAKE-LST generates on your choice of 3 1/2" or 5 1/4" diskette,
  259.          complete printed documentation, the latest version, updates to all
  260.          future releases and complete lifetime product support. To register
  261.          your copy please complete the included form (REGISTER.FRM), and
  262.          return it to the address on the form.
  263.  
  264.          Questions And Or Comments
  265.          =========================
  266.          If you have questions or comments about this or any other
  267.          Lightning Software product, please write to the address below
  268.          or call the Lightning Software support BBS (Software Express)
  269.          at (404) 941-2822 24 hours a day.
  270.  
  271.  
  272.                                   Lightning Software
  273.                                      P.O. Box 177
  274.                                 Lithia Springs, Ga 30057
  275.